home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / amiutils / u_z / xfigsupport / readme < prev    next >
Text File  |  1995-12-30  |  11KB  |  261 lines
  1. ===============================================================
  2. XFIG - Facility for Interactive Generation of figures under X11
  3. ===============================================================
  4.  
  5.  
  6. Xfig is a menu-driven tool that allows the user to draw and manipulate objects
  7. interactively in an X window.  The resulting pictures can be saved, printed
  8. on postscript printers or converted to a variety of other formats (e.g. to
  9. allow inclusion in LaTeX documents).
  10.  
  11. This file contains some notes about installing xfig, the directory
  12. 'Examples' contains some example figures and the 'Doc' directory contains
  13. some further documentation including the manual in troff -man format
  14. and PostScript.
  15.  
  16. ***************************************************************************
  17. Please refer any questions/bug fixes/contributions etc. about TransFig or 
  18. xfig to me.
  19.  
  20. Brian Smith
  21. Lawrence Berkeley Laboratory
  22. bvsmith@lbl.gov
  23. ***************************************************************************
  24.  
  25. Note that although I work at Lawrence Berkeley Laboratory (LBL) I don't speak 
  26. for LBL nor do I represent LBL with respect to my work on TransFig and xfig,
  27. nor does LBL make any representations about the suitability of this software 
  28. for any purpose.
  29. Here is the legal part:
  30.  
  31. THE LAWRENCE BERKELEY LABORATORY DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS 
  32. SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  33. EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL 
  34. DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, 
  35. WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING 
  36. OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  37.  
  38. ++++++++++++++++++++++
  39. NOTE about version 3.0
  40.  
  41.   An error in version 3.0 incorrectly positioned objects on the canvas
  42.   when reading older fig files.  New objects entered with 3.0 are
  43.   correctly positioned.  A warning will popup when you load a version 3.0
  44.   file with version 3.1 that says you might need to offset your figure by
  45.   14 fig units in X and Y when you load it.  This is done by setting the
  46.   X and Y offset in the popup File panel.
  47.   I apologize for the inconvenience.
  48.  
  49.   This is also why the file version number has changed.
  50.  
  51. ++++++++++++++++++++++
  52.  
  53. ===================
  54. INSTALLATION NOTES:
  55. ===================
  56.  
  57. 1. Edit the Imakefile if you need to customize it (see following notes)
  58. 2. Type "xmkmf" to create the Makefile from the Imakefile
  59.    2a. For a 3D look, see NOTE below
  60. 3. Type "make install" (if you don't do this step, be sure to install resources)
  61. 4. Type "make install.man"
  62. 5. For X11R5 color implementations, specify "*customization: -color" in your 
  63.     .Xdefaults or .Xresources file.
  64.     NOTE: this only works under X11R5.
  65.  
  66. If you have the XPM3 package (X11 color pixmaps) you can export your figures
  67.    in that format.  Also, you can import xpm files as picture objects.
  68.    Uncomment the XPMDEFINES and related variables in the Imakefile in that case.
  69.    You need version 3.4c or newer.  This is available from ftp.x.org in
  70.    /contrib/libraries.
  71. If you have ghostscript, enable the -DGSBIT flag in the Imakefile and xfig will
  72.    attempt to use it to interpret any encapsulated Postscript (EPS) files you
  73.    import.  Ghostscript must be compiled with with the "gif8" and "pbmraw"
  74.    drivers.  The pbm driver is used when you run xfig on a monochrome display
  75.    and the gif8 driver is used on a color display.
  76. If your system doesn't have strstr(), add the flag -DNOSTRSTR in the Imakefile
  77.    in the DEFINES line.
  78. If you are running on an IBM RS/6000 with AIX 3.2 or a Sun with Solaris 2.3,
  79.    uncomment the lines that define DPSLIB and DPSDEF in the Imakefile and you
  80.    will see the full PostScript object when using EPS objects.
  81. If you have an input tablet and your X server supports the XInputExtension
  82.    uncomment the lines that define TABLIB and USETAB in the Imakefile.
  83.    Start xfig with -tablet or define the resource Fig.Tablet to use it.
  84.  
  85. NOTE: For a 3D look, I recommend using Kaleb Keithley's 3D Athena Widget set,
  86. a direct replacement for the Xaw library.  After you compile and install that
  87. package, and after step 1 above, just uncomment the definition of XAWLIB in
  88. the Imakefile and it will use the 3D widget set.
  89. This set is available from ftp.x.org.
  90.  
  91. The maximum width of the top ruler is set to 1020 pixels and the height of the
  92. side ruler to 860 pixels.  If your server can handle pixmaps larger than this
  93. and you need longer/taller rulers, you may set the maximum allowed in your
  94. Imakefile with -DMAX_TOPRULER_WD=1160 (or whatever value you wish) and 
  95. -DMAX_SIDERULER_HT=1024 (or whatever value you wish).
  96.  
  97. The SMOOTHMOTION option toggles between two methods for tracking the
  98. cursor.  The first way (SMOOTHMOTION) just uses the (x,y) information given
  99. in the X pointer motion event.  If your display server doesn't implement
  100. motion compression this is very slow for large movements of the mouse
  101. pointer because X sends back lots of small movement events, each of which
  102. causes the rubberband box to be erased and redrawn.  The alternative
  103. way (not SMOOTHMOTION) queries the position of the X cursor whenever
  104. a motion event is received and if you make a large movement and then
  105. stop actually turns out to involve less work even though the XQueryPointer
  106. call is quite slow.
  107.  
  108. The SMOOTHMOTION flag MIGHT be necessary for older versions of OpenWindows on
  109. certain machines if the performance is slow when moving or drawing objects.
  110.  
  111. ----------------------
  112. Printing your figures:
  113. ----------------------
  114.  
  115. The program to translate your figure into one of many printer languages
  116. (Postscript, LaTex, etc) is called fig2dev and is part of the TransFig
  117. package put together by Micah Beck and maintained by Brian Smith.
  118. It is available from ftp.x.org in /contrib/applications/drawing_tools/transfig.
  119. See the man pages for more information.
  120.  
  121. If you have a SYSV system but use BSD-style printing (lpr instead of lp) you
  122. must define -DBSDLPR in the Imakefile/Makefile.
  123.  
  124. You may also need to uncomment the following string in the Fig.ad
  125. app-defaults file:
  126.  
  127. !Fig*job_params*string:        -oPS
  128.  
  129. -----------------
  130. Solaris users
  131. -----------------
  132.  
  133. You should have:
  134.  
  135. #define SystemV YES
  136. #define SystemV4 YES
  137.  
  138. in your imake machine config file (usually in /usr/lib/X11/config or something
  139. like that).
  140.  
  141. Add "-lc" to the LOCAL_LIBRARIES variable in the Imakefile to link with 
  142. /usr/lib/libc for the directory operations.
  143.  
  144. Some people have had trouble with the Sun cc 3.0.1 compiler and optimization.
  145. You may need to shut off optimization.
  146. A common symptom is that xfig just core dumps when starting.
  147.  
  148. ----------------------------------------------
  149. Possible problems encountered installing xfig:
  150. ----------------------------------------------
  151.  
  152. PROBLEM:
  153.     When using LaTeX fonts in Xfig I always end up with postscript
  154.     fonts instead rather than, say, Computer Modern. 
  155.  
  156. POSSIBLE CAUSE AND SOLUTION:
  157.     To put fonts under the control of LaTeX when generating PS, you must
  158.     tag the text object as "special" and then use the pstex output mode.
  159.     This mode forces special text objects to be passed through to LaTeX,
  160.     allowing the use of Math mode and CM fonts among other things.
  161. ________________________________________________________________________________
  162. PROBLEM:
  163.     On a DEC Alpha the compiler may complain about something like: ".mask
  164.     must have pcreg from .frame set if any bits are set in .mask or .fmask"
  165.     in the file u_bound.c.
  166.  
  167. POSSIBLE CAUSE AND SOLUTION:
  168.     Set the optimization level to -O1 at least for that file.
  169. ________________________________________________________________________________
  170. PROBLEM:
  171.     On Sun machines the linker may give erroneous error messages about 
  172.     the following symbols being undefined:
  173.  
  174.     ld: Undefined symbol
  175.        _get_applicationShellWidgetClass
  176.        _get_wmShellWidgetClass
  177.  
  178.     This may be ignored as it is a problem with the Sun shared libraries
  179.     and the way X11 builds the shared Xmu library.  It doesn't affect the
  180.     operation of xfig.
  181.  
  182.     Or you may compile with "-Bstatic -lXmu -Bdynamic".
  183.     To really solve the problem if you are using OpenWindows 3.0
  184.     (X11R4-based Xt), please contact your local Sun office and request the
  185.     following patches:
  186.  
  187.         Patch i.d.      Description
  188.         100512-02       4.1.x OpenWindows 3.0 libXt Jumbo patch
  189.         100573-03       4.1.x OpenWindows 3.0 undefined symbols when using
  190.                                 shared libXmu
  191.  
  192.     A source patch for use with the MIT X11R4 libraries was developed by
  193.     Conrad Kimball (cek@sdc.boeing.com); it retrofits into R4 some fixes
  194.     made in R5 to get around this problem. The patch is on export in [1/93]
  195.     contrib/X11R4_sunos4.1.2_patch_version3.Z".
  196.  
  197.     The other option is to use X11R5 or X11R6.
  198. ________________________________________________________________________________
  199. PROBLEM:
  200.     The window oscillates and fights with the window manager when
  201.     I click on a mode button or try to resize the xfig window.
  202.  
  203. POSSIBLE CAUSE AND SOLUTION:
  204.      Perhaps the following resource has been set
  205.          *allowShellResize: true
  206.     because another program requires it to be true.
  207.     Change the resource to be specific to the programs which need it,
  208.     or set the following resource:
  209.          Fig*allowShellResize: false
  210.     Note: this is in the Fig.ad file that comes with xfig, which is 
  211.           installed when you do a "make install".
  212. ________________________________________________________________________________
  213. PROBLEM:
  214.     Openwindows sometimes loses track of xfig's icon.
  215.  
  216. POSSIBLE CAUSE AND SOLUTION:
  217.     Cause unknown, here is a temporary kludge. Place the line:
  218.         Fig*iconPixmap:               ..../your_lib_area/fig.icon.X
  219.     in your .Xdefaults file and copy fig.icon.X into your lib area.
  220. ________________________________________________________________________________
  221. PROBLEM:
  222.     When compiling on an HP 750 running HP-UX 8.05, the compiler dies with
  223.     a bus error in the file u_undo.c.
  224.  
  225. POSSIBLE CAUSE AND SOLUTION:
  226.     There is a bug in the HP compiler.  Workaround the problem by adding
  227.     an extra statement between two statements in u_undo.c:
  228.  
  229.     Original:
  230.  
  231.     undo_glue()
  232.     {
  233.         list_delete_compound(&objects.compounds, saved_objects.compounds);
  234.         tail(&objects, &object_tails);
  235.  
  236.     New:
  237.  
  238.     undo_glue()
  239.     {
  240.         list_delete_compound(&objects.compounds, saved_objects.compounds);
  241. >>>        /* HP-UX 8.05 compiler bug fix -- don't ask */
  242. >>>        last_action = last_action;
  243.         tail(&objects, &object_tails);
  244. ________________________________________________________________________________
  245. PROBLEMS:
  246.     On HP machines, the capitalization of some letters in the text window 
  247.     in the edit popup for text objects are wrong.
  248.  
  249. POSSIBLE CAUSE AND SOLUTION:
  250.     Make sure that the CompKeyDB file has the lowercase letter definitions
  251.     BEFORE the uppercase definitions.  This should be the case for the 
  252.     CompKeyDB file shipped with xfig 2.1.5 and later.
  253. ________________________________________________________________________________
  254. PROBLEMS:
  255.     On HP computers using cc compiler version A.09.61 there is a problem with
  256.     level 3 optimization.  Use +O2 instead of +O3.
  257.  
  258. POSSIBLE CAUSE AND SOLUTION:
  259.     Use level 2 instead.
  260.  
  261.